home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / doom / quake1.zip / POV2MA91.ZIP / POV2MAP.TXT < prev   
Text File  |  1996-08-20  |  8KB  |  239 lines
  1. !!!!!!!!!h                        .:!!!!h.   !!h      !!!                  
  2. !!!     !!!  :<!!!!:. 4!:    <!  '!~    `!>  !!!!    !!!!     !!     !!!!!!!!
  3. !!!::::<!! .!!~   `4!. !!:  <!~      .:<!~   !! !! .!!`!!    !!!!    !!!   '!
  4. !!!``````  !!!      !!  !! :!~    :!!~``     !!  4!!! '!!   !!~`!!   !!!!!!!!
  5. !!!        '!!.    :!!  '!!!~    <!          !!   ~!  '!!  <!!!!!!!  !!!     
  6. !!!         `4!!!!!!~    '!!     !!!!!!!!!!  !!       '!! <!!    ~!h !!!     
  7.  
  8.  
  9. ------------------------------------------------------------------------------
  10.             8/19/96 - Version 0.9 - Pov2Map File Conversion Utility
  11.        New versions at http://www.olympus.net/personal/danks/john/pov2map.htm
  12.  
  13.                                     ***
  14.  
  15.                       Created by darksead AKA John Danks
  16.                             email: danks@olympus.net
  17.  
  18.                                     ***
  19.  
  20.           Support Free Speech, on the interenet and everywhere else!
  21.  
  22.  
  23. Contribute!!!
  24. -------------
  25.  
  26. If you make a map (any map, no matter how lame you think it is) send it to me!
  27. I'm so busying with programming I haven't had much time to exploit Pov2Map's
  28. great features.
  29.  
  30. Also, if you want to write documentation or be an official beta tester then
  31. mail me at danks@olympus.net!
  32.  
  33.  
  34. Changes From 0.6 to 0.9
  35. -----------------------
  36.  
  37. Rotations are now fully functional. Scaling and translation are now much more
  38. stable.
  39.  
  40. A very BIG thank you goes out to Tauno Taipaleenmaki <tataipal@raita.oulu.fi>
  41. for his help in supporting rotations. Also, another big thanks to Dan Olsson,
  42. aka Scohop <elvis@iaonline.com> for beta testing and geneal support and
  43. motivation.
  44.  
  45.  
  46. Changes From 0.5 to 0.6
  47. -----------------------
  48.  
  49. Lights are now supported!  They will appear as positioned in the .pov file.
  50. Their intensity is taken from the red component of the light and multiplied
  51. by 500.
  52.  
  53. Also, it will not crash when you don't give it any filenames. Now, it writes
  54. an error to the screen and shows you the correct syntax.
  55.  
  56. Displays info about parsing progress.
  57.  
  58.  
  59.  
  60. Introduction
  61. ------------
  62.  
  63.   This utility has been created because no one would let me beta test their
  64. Quake Level Editors.  I as poking around on ftp.cdrom.com and I found Quake
  65. Brush Generator 1.00 by Niklata.  This great utility makes a rectangular
  66. brush out of two 3d points.  Then I remembered that the syntax for a box in
  67. povray was:
  68.  
  69. box {
  70.   <-1, -1, -1>, <1, 1, 1>  <--- Two 3d points
  71.     texture {
  72.         Texture_Name
  73.     }
  74.     scale <x, y, x>
  75.     translate <x, y, z>
  76. }
  77.  
  78. And then Pov2Map was born.
  79.  
  80.  
  81.  
  82. ---------------
  83. Files Included:
  84. ---------------
  85.  
  86. POV2MAP.EXE   - Pov2Map conversion utility
  87. POV2MAP.TXT   - Pov2Map manual.
  88. EXAMPLE.MDL   - Moray 2.0 datafile to accompany example.
  89. EXAMPLE.POV   - Exported version of EXAMPLE.MDL
  90. EXAMPLE.MAP   - Pov2Map converted version of EXAMPLE.POV
  91. DEMO.MDL      - Files for a uncompleted level I was testing with.
  92. DEMO.POV      -   "     "
  93. DEMO.MAP      -   "     "
  94.  
  95. -------------
  96. Requirements:
  97. -------------
  98.  
  99. * Moray 2.0 or newer
  100.  
  101. * QBSP, LIGHT AND VIS
  102.  
  103. * SW QUAKE 0.9x
  104. (Newer versions will not run external maps unless registered, so REGISTER!)
  105.  
  106. * REGISTERED QUAKE
  107.  
  108. -------------
  109. Restrictions:
  110. -------------
  111.  
  112. Unions do not work if you export the file, but you can use them while creating
  113. the level and then ungrouping everything before export. Currently, if you use
  114. a union, intersecton, difference, or merge the objects within them will not be
  115. converted. This is useful for building small parts of levels at a time.
  116.  
  117. ----------------
  118. Syntax and Usage
  119. ----------------
  120.  
  121.   Pov2Map is very easy to use. Simply type:
  122.  
  123. pov2map <inputname.pov> <outputname.map>
  124.  
  125.  Where <inputname.pov> is the povray source file generated by Moray, and
  126.  <outputname.map> is the name you wish to have for the resulting .MAP file.
  127.  
  128. Example:
  129.  
  130.   Startup Moray.
  131.  
  132.   Create a cube and scale it by <100,100,1> and translate it by <-1,-1,-1>
  133.  
  134.   Go to the texture editor and create a texture called TECH07_2
  135.  
  136.   Exit and give the cube TECH07_2 as a texture.
  137.  
  138.   Repeat this for the following five cubes with these values:
  139.  
  140.   Cube 2: scale <100, 1, 100> translate<  -1, -101,  99>
  141.   Cube 3: scale <100, 1, 100> translate<  -1,   99,  99>
  142.   Cube 4: scale <1, 100, 100> translate<-101,   -1,  99>
  143.   Cube 5: scale <1, 100, 100> translate<  99,   -1,  99>
  144.   Cube 6: scale <100, 100, 1> translate<  -1,   -1, 199>
  145.  
  146.   Save this as example.mdl and then export it to a povray file.
  147.  
  148.   Copy it from your \moray\povscn directory to where ever you are keeping
  149.   Pov2Map.
  150.  
  151.   Type:
  152.  
  153.     pov2map example.pov example.map
  154.  
  155.   Run it through qbsp, light and vis.
  156.  
  157.     qbsp example.map
  158.     light example.bsp
  159.     vis -v example.bsp
  160.  
  161.   If vis says "no vising was performed then it means that you have an opening
  162.   in your level. Go back and check to make sure that all of the cubes are
  163.   touching or overlapping and the enclosed space is "air tight".
  164.  
  165.   Copy example.bsp to you \quake\id1\maps directory and start quake with:
  166.  
  167.     quake +map example
  168.  
  169.   If you've done everything correctly you should be in a small cubical room.
  170.   If there is a hole, you will see a neutral gray area in between two walls.
  171.  
  172.   Different textures can be used by giving the cube a texture with a name
  173.   identical to the one in the graphics wad such as COMP1_3 or Tech07_2.
  174.   Water and sky can also been done with names like *WATER0 or SKY4.
  175.  
  176.   After you create a level in Moray you need to edit the output of pov2map
  177.   and add entities such as lights and monsters. If I'm working on a rather
  178.   complex level, I usually keep all of my entities in a seperate text file
  179.   and paste them in to the .map file when I want to test it.  Also, if you
  180.   do not include any lights the map will be equally lit throughout the entire
  181.   level.  Pov2Map automatically places a player entity at  <0,0,64>. If this
  182.   is a problem please contact me at the address below.
  183.  
  184.  
  185.  
  186. -------------
  187. How It Works:
  188. -------------
  189.  
  190. Pov2Map searches the povray source file for a definition of a box and then
  191. reads in the points. It also looks for a texture name and a scale, translate,
  192. or rotate keyword.
  193.  
  194. If you want to know more about the conversion process, then mail me.
  195.  
  196.  
  197.  
  198. -------------
  199. Improvements:
  200. -------------
  201.  
  202. I will develop Pov2Map until I find a decent Quake Editor. Maybe even after
  203. that if there is anyone still interested in it.
  204.  
  205. Intersections, and Differences will probably never be implemented.
  206.  
  207. I was also thinking of using the objects name in Moray as a comment in .MAP
  208. file to identify different objects for more advanced editing.
  209.  
  210. I am now thinking about using the name of the object in Moray to pass info to
  211. Pov2Map. This would make it possible to place entities in a level. Lights
  212. could be controlled, you could change them from invisible point lights to
  213. torches.
  214.  
  215. If you would like this then contact me or it may never be added!
  216.  
  217. If you are interested in creating a web page for Pov2Map please contact me!
  218. I would do it myself, but it would have to be text only because I have no
  219. access to uploading with FTP.
  220.  
  221. I'm taking ideas, suggestions, and criticism at:
  222.  
  223. darksead@scn.org
  224.  
  225.                                                     
  226. ----------
  227. Thank You:
  228. ----------
  229.  
  230. id Software of course.        - Quake is so cool. The $50 cd is worth it just
  231.                                 for the amazing nin music!!!
  232.  
  233. Niklata (Nicholas Dwarkanath) - For Quake Brush Generator, and the specs
  234.                                 about entites and maps.
  235.  
  236. Dan Olsson (Scohop)           - Lead (and only) Beta Tester. Big supporter.
  237.  
  238. Tauno Taipaleenmaki           - Showed me how to implement rotations.
  239.